發表於 |

Gitlab Runner

中文文檔

安裝 runner

  1. 建立一個目錄 例如:C:\GitLab-Runner

  2. 下載對應的gitlab-runner版本，將下載的檔案更改名稱為gitlab-runner.exe。

x86
x64

  1. Registering Runners

官方註冊教學

3.1 打開cmd(管理員執行)

3.2 输入 GitLab 实例 URL:

1
./gitlab-runner.exe register

3.3 输入 GitLab 实例 URL:

1
2
Please enter the gitlab-ci coordinator URL
http://192.168.1.112/

3.4 输入获取到的用于注册 Runner 的 token:

1
2
Please enter the gitlab-ci token for this runner
1Y6skuaKaYDyNucjYS9_

3.5 输入该 Runner 的描述，稍后也可通过 GitLab’s UI 修改:

1
2
Please enter the gitlab-ci description for this runner
[hostame] my-runner test

3.6 给该 Runner 指派 tags, 稍后也可以在 GitLab’s UI 修改:

1
2
Please enter the gitlab-ci tags for this runner (comma separated):
my-tag,another-tag

3.7 选择 Runner 是否接收未指定 tags 的任务（默认值：false）， 稍后可以在 GitLab’s UI 修改：

1
2
Whether to run untagged jobs [true/false]:
[false]: true

3.8 选择是否为当前项目锁定该 Runner， 之后可以在 GitLab’s UI 修改。 该功能通常用于被指定为某个项目的 Runner （默认值：true）：

1
2
Whether to lock Runner to current project [true/false]:
[true]: true

3.9 选择 Runner executor:

1
2
Please enter the executor: ssh, docker+machine, docker-ssh+machine, kubernetes, docker, parallels, virtualbox, docker-ssh, shell:
shell

3.10 如果你选择 Docker 作为你的 executor，注册程序会让你设置一个默认的镜像， 作用于 .gitlab-ci.yml 中未指定镜像的项目：

1
2
Please enter the Docker image (eg. ruby:2.1):
alpine:latest

如果你想在同一台机器上注册多个 Runner，可以重复运行 ./gitlab-runner.exe register 这个命令进行配置。

  1. 將Runner作為服務安裝並啟動它。您可以使用內置系統帳戶（推薦）或使用用戶帳戶運行服務。
  • 使用內置系統帳戶運行服務
1
2
gitlab-runner install
gitlab-runner start

  • 使用用戶帳戶運行服務

您必須輸入當前用戶帳戶的有效密碼，因為它需要Windows啟動服務：

1
2
gitlab-runner install --user ENTER-YOUR-USERNAME --password ENTER-YOUR-PASSWORD
gitlab-runner start

如果您在Runner安裝過程中遇到任何錯誤，請參閱故障排除部分。

  1. （可選）更新運行程序的concurrent值C:\GitLab-Runner\config.toml 以允許多個並發作業，如高級配置詳細信息中所述。另外，您可以使用高級配置詳細信息來更新您的shell執行程序以使用Bash或PowerShell而不是批處理。

瞧！Runner已安裝，正在運行，並且將在每次系統重新啟動後重新啟動。日誌存儲在Windows事件日誌中。

更新

  1. 停止服務（您需要像以前那樣提升命令提示符）：

    1
    2
    cd C:\GitLab-Runner
    gitlab-runner stop

  2. 下載x86或amd64的二進製文件並替換runner的可執行文件。您可以下載Bleeding Edge中所述的每個可用版本的二進製文件 - 下載任何其他帶標籤的版本。

  3. 開始服務：

    1
    gitlab-runner start

卸載

  1. 從提升的命令提示符：
    1
    2
    3
    4
    5
    cd C:\GitLab-Runner
    gitlab-runner stop
    gitlab-runner uninstall
    cd ..
    rmdir /s GitLab-Runner

故障排除

確保您閱讀了常見問題部分，其中介紹了GitLab Runner最常見的一些問題。

如果您遇到類似帳戶名稱的錯誤，請嘗試.\在用戶名之前添加：

1
gitlab-runner install --user ".\ENTER-YOUR-USERNAME" --password "ENTER-YOUR-PASSWORD"

如果您遇到a 服務在啟動服務時由於登錄失敗錯誤而無法啟動，請查看常見問題解答以檢查如何解決問題。

如果您沒有Windows密碼，Runner的服務將無法啟動，但您可以使用內置系統帳戶。

如果您對內置系統帳戶有問題，請閱讀 如何 使用Microsoft支持網站上的內置系統帳戶啟動服務。